home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3dm / audiofile / AFgetfd.z / AFgetfd
Encoding:
Text File  |  2002-10-03  |  3.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. aaaaffffGGGGeeeettttFFFFDDDD((((3333ddddmmmm))))                                                      aaaaffffGGGGeeeettttFFFFDDDD((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      afGetFD - get the Unix file descriptor for the file associated with an
  10.      AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee structure
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiiooooffffiiiilllleeee....hhhh>>>>
  14.  
  15.      iiiinnnntttt aaaaffffGGGGeeeettttFFFFDDDD((((AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee ffffiiiilllleeee))))
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  18.      _f_i_l_e   is an AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee structure for the audio file whose file
  19.             descriptor you wish to obtain.  This structure is the returned
  20.             value of an aaaaffffOOOOppppeeeennnnFFFFiiiilllleeee(3dm) call.
  21.  
  22. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  23.      aaaaffffGGGGeeeettttFFFFDDDD(((()))) returns a nonnegative Unix file descriptor if _f_i_l_e is
  24.      associated with an open file, or -1 in event of an error.
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      aaaaffffGGGGeeeettttFFFFDDDD(((()))) returns the Unix file descriptor associated with a file
  28.      previously opened via a call to aaaaffffOOOOppppeeeennnnFFFFiiiilllleeee(3dm).
  29.  
  30. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  31.      The file descriptor returned by aaaaffffGGGGeeeettttFFFFDDDD(((()))) was intended to be used as part
  32.      of a sssseeeelllleeeecccctttt(2) loop and was not intended to allow users to read, write,
  33.      and seek in the file without the knowledge (i.e., independently) of the
  34.      Audio File Library.  Many of the routines in the Audio File Library will
  35.      not function correctly if the user changes the file position on the file
  36.      descriptor returned by this function.  See the section _C_A_V_E_A_T_S _F_O_R _U_S_I_N_G
  37.      _T_H_E _H_A_N_D_L_E'_S _F_I_L_E _D_E_S_C_R_I_P_T_O_R in aaaaffffIIIInnnnttttrrrroooo(3dm) and aaaaffffSSSSaaaavvvveeeeFFFFiiiilllleeeePPPPoooossssiiiittttiiiioooonnnn(3dm)
  38.      for important information about how to deal with this situation.
  39.  
  40. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  41.      aaaaffffOOOOppppeeeennnnFFFFiiiilllleeee(3dm), aaaaffffCCCClllloooosssseeeeFFFFiiiilllleeee(3dm), aaaaffffSSSSaaaavvvveeeeFFFFiiiilllleeeePPPPoooossssiiiittttiiiioooonnnn(3dm),
  42.      aaaaffffRRRReeeessssttttoooorrrreeeeFFFFiiiilllleeeePPPPoooossssiiiittttiiiioooonnnn(3dm)
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.